home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 2 / United Public Domain Gold 2.iso / utilities / pu300.dms / pu300.adf / Tutor.1 / Documentation < prev    next >
Text File  |  1990-05-26  |  5KB  |  100 lines
  1. MORSE.DOC Version 1.1    Copyright 1987 by Peter V. Inskeep
  2. This is the documentary information for the programs morse.s and morse.r.
  3. They were written by Peter V. Inskeep, Amateur Radio Call, NO2D.
  4. My address is:
  5.     6 Clearview Drive
  6.     Long Valley
  7.     New Jersey
  8.     07853
  9.  
  10. I can be reached via email on Compuserve, 72017,1211.
  11. I also hang out sometimes on the low end of 20 meters in the evening.
  12. You may feel free to use or abuse the attached source code as you see fit
  13. so long as you do not sell it for profit or use it in a program for profit
  14. without my prior written consent.
  15.  
  16. The atttached file, morse.s, is the source code for a morse code practice
  17. sending session, and morse.r, is the run file for the same
  18. program, and can be run from the cli.  I never tried to run it from the 
  19. workbench.  I suppose it might run if you constructed or borrowed an icon
  20. for it from some other program.  It is written entirely in assembly
  21. language and compiled with the Metacomco assembler and linker.
  22.  
  23. Most of what happens is explained in the comments which follow each line
  24. of code.  I can add a few clarifying comments, however.  The INCLUDE files
  25. were avoided because they add so to assembly time when testing. 
  26. If you prefer to use the INCLUDE files, then set the equates accordingly,
  27. so that you do not get hundreds of multiple definition errors.  There are
  28. probably some INCLUDE files which I have not included, but which will
  29. have to be added in order to assemble properly using the INCLUDE files.
  30. The Outfile.equ file was created by setting the -e option on the 
  31. assembler and running a dummy assembly program with all of the INCLUDE
  32. files whose equates you want or need.  This from a copy of The Trans-
  33. actor some months back.  It is much faster than just using the INCLUDE
  34. files, but not as fast as setting only the needed equates in the source.
  35.  
  36. Version 1.1 has some changes from the original version.  I corrected an
  37. error noted by Peter S., whereby the random code generator was not
  38. generating all of the letters of the alphabet (who would notice that).
  39. Also, I added a menu item to permit selection of random code with or
  40. without numbers and punctuation.  Many people learning code find it
  41. easier to concentrate on letters only, and to pick up the numbers later.
  42. A better, shorter easier clear screen routine was added.
  43.  
  44. I also created a DoIO call that would be less CPU intensive for timing
  45. the length of dot and dash  elements.  I am indebted to Darrel
  46. Schneider's program SpriteClock for pointing out how to properly open
  47. and close the IO TimeRequest Structure so that my task would sleep
  48. while the dots and dashes were being sent.  The suggestion for this
  49. improvement also came from Peter S., who may be the only person who
  50. has even looked at the program.
  51.  
  52. There is a color 3 stripe that sometimes appears across the top of the
  53. screen.  It was put in to add color to a dull program.  If it bothers
  54. then look for a pair of 2's in the drawline structure, and change them
  55. to a pair of 0's.
  56.  
  57. A subroutine, sendmorse, has been added to send a null terminated string
  58. pointed to in address register a5.  If you wish to add specific code to
  59. send just write the string into the data section, terminated with a zero,
  60. put a pointer in a5, and bsr to sendcode.
  61.  
  62. As I was debugging one or another of the problems with this program I
  63. was listening on 40 meters with my old second hand flea market Heath-
  64. kit HW-7 QRP (very low power) transceiver.  I made contact with K6RM
  65. in San Francisco, 3,000 miles away.  On three watts input power!
  66. The sun spot cycle is beginning to climb rapidly.  There has never been a
  67. better time to become active in Amateur Radio.  Now that Novices have
  68. voice privleges on 10 meters and 220 Mhz., they can work around the
  69. world with increasing ease, and work through local repeters while mobile
  70. or on foot with small handi-talkies.  If you don't know how to get
  71. started, contact the ARRL in Newington, Conn. (Publishers of QST
  72. Magazine), and ask them for the name of a ham radio club near you.  If
  73. you take the first steps you will enter a hobby that will provide you with
  74. lots of interesting variety for many years to come.  As well, Ham Radio
  75. and Computers are natural stable mates, and both hobbies come into play
  76. in a variety of ways in Ham Radio.
  77.  
  78. The primary purpose for writing this program was to see if I could learn how
  79. to create menus, proportional gadgets, and images in assembly language.
  80. Therefore, the code section is rough.  I have not even tried to create an
  81. output so that one can feed the code to the transmitter.  This is usually
  82. done with an output on one of the joystick pins, and I guess would not
  83. be hard to do.  With all of the ports on the back of the Amiga, there must
  84. be an even better way to do that.
  85.  
  86. There is an Amiga Amateur Radio net operating at 3.882 Megahertz on
  87. Tuesday nights at 7:00 pm eastern time.  Tune in for helpful
  88. information on the Amiga.
  89.  
  90. I have pilfered assembly language algorythms from many sources to put this
  91. program together.  Primary among them have been "68000 Assembly Language
  92. Programming", by L. Leventhal, Compute's Amiga Programmer's Guide, edited
  93. by S. Levy and the various issues of The Transactor, which has got to be
  94. the definitive mag for the Commodores and the Amiga.  Specific thanks to
  95. Peter S. and Darrel Schneider for ideas on random numbers and DoIO.
  96.  
  97. I hope you enjoy this and don't hesitate to write if you have
  98. questions.  73's      Pete   N02d      CIS  72017,1211
  99.  
  100.